Barcode Xpress 10 for .Net - User Guide > How To > Debug Your Application |
Because debugging and writing debug information to a log file is time consuming and expensive, Barcode Xpress provides the ability to control the level of information written to the debug log as well as the ability to turn off writing to a file completely.
Use the objects below to adjust the settings of your debugging, event handling, memory, and IDispose for optimal performance.
When ErrorLevel is set to Detailed, BarcodeXpress will log most of your calls to the component including the occurrence of exceptions, the result of most major operations and the operation of each event it raises. |
Barcode Xpress may throw a number of exceptions if it comes across errors or events that need to be handled by the application. These exceptions are tabulated below:
Exception | Description |
ColumnCountException | Thrown if the input columns are outside the valid range for a 2D barcode type to be created. |
ErrorCorrectionLevelTooHighException | Thrown if the input barcode data will fit in the 2D barcode but the error correction words will not fit because there are more error words than will fit in the remainder of the symbol. |
ImageNotAvailableException | Thrown whenever there is no image available for an operation that requires one. |
InsufficientHeightException | Thrown if the Height value set by the user is smaller than the required height of the barcode. |
InsufficientWidthException | Thrown if the barcode Width value set by the user is smaller than the required width of the barcode. |
InternalErrorException | Thrown whenever an unhandled exception is encountered. |
InvalidAreaException | Thrown whenever an invalid area is used in barcode recognition. |
InvalidBarcodeValueException | Thrown if the BarcodeValue is NULL, or if the barcode value set is invalid for the current barcode type. |
InvalidBitmapException | Thrown if an invalid bitmap is detected. |
InvalidErrorCorrectionLevelException | Thrown if the error correction level is not in the valid range for the 2D barcode type. |
InvalidIndexException | Thrown if a request for results is outside the valid range. |
InvalidLicenseException | Thrown if an invalid license is detected. |
InvalidParameterException | Thrown if a parameter is invalid. |
LargeDataSizeException | Thrown if the barcode data will not fit in the current symbols rows and columns. |
OutOfMemoryException | Thrown if the creation of the bitmap to draw the barcode fails. |
ParameterOutOfRangeException | Thrown if a parameter is out of range. |
PDF417EncodingException | Thrown if an internal exception has occurred while trying to encode the barcode data. |
RowCountException | Thrown if the input columns are outside the valid range of the 2D barcode type to be created. |
StringParseErrorException | Thrown if a parse error is encountered in the ReadFromStream method. |
TimeoutErrorException | This exception is not used. |
UnableCreateUPCEException | Thrown if the function to expand a UPC-E value to a UPC-A value fails. |
UnableReadBarcodeTypeException | Thrown if an unsupported barcode type is detected. |
UnsupportedBarcodeTypeException | Thrown if an unsupported barcode type is detected. |
UnableReadBitmapException | Thrown when a bitmap cannot be read, possibly because of an invalid bitmap handle. |
Listed below is a cross reference of error codes and their corresponding descriptions.
Error Codes | Error | Description |
9000 |
OutOfMemoryException |
There is not enough memory to continue the operation. |
9001 |
InvalidParameterException |
Invalid parameter. |
9002 |
ParameterOutOfRangeException |
Parameter out of range. |
9003 |
InvalidBitmapException |
Invalid bitmap. |
9004 |
UnableReadbitmapException |
Unable to read bitmap. |
9005 |
UnsupportBarcodeTypeException |
Unsupported barcode type. |
9006 |
InvalidIndexException |
Invalid index. |
9007 | InvalidBarcodeValueException | Invalid barcode value set. |
9008 | InsufficientWidthException | Insufficient barcode width. |
9009 | InsufficientHeightException |
Insufficient barcode height. |
9010 |
UnableCreateUPCEException |
Unable to create UPC-E Barcode. |
9011 |
InvalidLicenseException |
Invalid license. |
9012 |
TimeoutErrorException |
Timeout Error. |
9013 |
ImageNotAvailableException |
Image not available. |
9014 |
InternalErrorException |
Internal error. |
9015 |
InvalidAreaException |
Area is outside required range. |
9100 |
PDF417EncodingException |
PDF417 encoding error. |
9101 |
RowCountException |
Invalid row count for the barcode type. |
9102 |
ColumnCountException |
Invalid column count for the barcode type. |
9104 |
LargeDataSizeException |
Barcode data too large for the barcode symbol size. |
9105 |
InvalidErrorCorrectionLevelException |
Error correction level is invalid. |
9106 |
ErrorCorrectionLevelTooHighException |
Error correction level is too high, will not fit in barcode symbol with the data. |
9200 | StreamParseException | An error was encountered while parsing the stream data in the ReadFromStream method. |
If you receive a System.PlatformNotSupportedException on a 64-bit operating system, check that the application has been compiled for the x86 platform. |